home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / pattr15.zip / PATTR.DOC < prev    next >
Text File  |  1990-11-06  |  13KB  |  418 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                               P A T T R I B U T E
  20.  
  21.  
  22.  
  23.                                    Patri-Soft
  24.                                  Norm Patriquin
  25.  
  26.  
  27.  
  28.                                    Version 1.5
  29.                                   November 1990
  30.  
  31.  
  32.  
  33.  
  34.                        Support BBS --  Patriquin's BBS
  35.                                        714-369-9766 (1200 - 14400 baud)
  36.  
  37.  
  38.  
  39.  
  40.                        Copyright 1990 by Patri-Soft
  41.  
  42.  
  43.  
  44.                         Table of Contents
  45.  
  46.  
  47.       What is PATTRIBUTE. . . . . . . . . . . . . . . . . . . .   1
  48.  
  49.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   2
  50.  
  51.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  52.  
  53.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   7
  54.  
  55.       Registration. . . . . . . . . . . . . . . . . . . . . . .   8
  56.  
  57.       Problems and Maintenance. . . . . . . . . . . . . . . . .  10
  58.  
  59.       Version History . . . . . . . . . . . . . . . . . . . . .  11
  60.  
  61.                                                                 Page  1
  62.  
  63.  
  64.       What is PATTR
  65.       ---------------
  66.  
  67.       PATTR sets DOS attributes for the files or filename wildcards
  68.       you specify.  Use it to set or reset archive status on files or
  69.       to protect/unprotect files with the readonly attribute.
  70.  
  71.       PATTR's file selection parameters provide you with numerous
  72.       options for specifying the files to be deleted.  You may select by
  73.       directory, file, date, attribute, size, and even starting and
  74.       ending filename.
  75.  
  76.  
  77.                                                                 Page  3
  78.  
  79.  
  80.       Command Parameters
  81.       ------------------
  82.  
  83.       PATTR allows several command parameter switches to be specified
  84.       to customize the process.  All these parameters are optional.
  85.       The command format and switch parameters are described below.  A
  86.       quick review of command parameters is always available by
  87.       entering the PDEL command with no parameters.
  88.  
  89.       COMMAND FORMAT:
  90.  
  91.       PATTR   filespec  [ (/ switches) ]
  92.  
  93.  
  94.       filespec  Enter a DOS file specification.  Pathnames and
  95.                 standard DOS wildcard characters are allowed.
  96.  
  97.  
  98.       /SA       Select files having the ARCHIVE attribute set.
  99.  
  100.  
  101.       /SS       Select files having the SYSTEM  attribute set.
  102.  
  103.  
  104.       /SH       Select files having the HIDDEN  attribute set.
  105.  
  106.  
  107.       /SR       Select files having the READONLY  attribute set.
  108.  
  109.  
  110.       /SO       Only useful when /SA /SS /SH /SR is also used.
  111.                 Indicates that files without HIDDEN, SYSTEM,
  112.                 READONLY attributes are also to be selected.
  113.  
  114.  
  115.                                                                 Page  4
  116.  
  117.  
  118.       /D:[(]xxx Date.  Select files based on the relationship between
  119.          [)]    their last update date and the date specified.  This
  120.          [=]    parameter includes a date or number of days value.
  121.                 It may also contain a modifier that reverses or
  122.                 modifies the use of the date specified.
  123.  
  124.                 When xxx contains a date the date is compared to the
  125.                 last update date of the file.  The last update date
  126.                 of the file is the date contained in its directory
  127.                 entry.  The file is selected if the condition specified
  128.                 by the condition modifier is met.  The condition
  129.                 modifier meanings are:
  130.  
  131.                   '(' =  Select files whose date is older than the
  132.                          date specified.
  133.  
  134.                   ')' =  Select files whose date is newer than the
  135.                          date specified.
  136.  
  137.                   '=' =  Select files whose date is equal to the date
  138.                          specified.
  139.  
  140.                 If the condition modifier is not specified, ')' is
  141.                 assumed.
  142.  
  143.                 Date values may be specified in any of the following
  144.                 formats:
  145.  
  146.                     MM/DD/YY   MM-DD-YY   DDMMMYY
  147.                     12/31/80   12-31-80   31DEC80
  148.  
  149.                 If xxx contains a numeric value, that positive number
  150.                 is used to calculate a date value a number of days
  151.                 prior to the current date.  Then that date is used
  152.                 as in the calculation above.
  153.  
  154.                 Example:
  155.  
  156.                 /D:(1JAN86  - Process files updated before 1JAN86
  157.                 /D:)1JAN86  - Process files updated after 1JAN86
  158.                 /D:=1JAN86  - Process files updated 1JAN86
  159.                 /D:(5  - Process files modified prior to 5 days ago
  160.                 /D:)5  - Process files modified within the last 5 days
  161.                 /D:=5  - Process files modified 5 days ago
  162.                                                                 Page  5
  163.  
  164.  
  165.       /F:file   First.  Indicates that processing is not to start until
  166.                 the specified full filename is encountered in the
  167.                 scan of the directory.
  168.  
  169.  
  170.  
  171.       /L:file   Last.  Indicates that processing is to stop after
  172.                 the specified full filename is encountered in the
  173.                 scan of the directory. The file specified will be
  174.                 processed if it matches selection criteria.
  175.  
  176.  
  177.  
  178.       /M        Stop screen from scrolling from scrolling past the end
  179.                 without user intervention (MORE).
  180.  
  181.  
  182.       /O        Indicates that all filenames except those matching
  183.                 the filename specified on the input command are to
  184.                 be selected for processing.
  185.  
  186.  
  187.  
  188.       /P        Pause before each file is updated to allow user
  189.                 to approve or reject the action for each file.
  190.  
  191.  
  192.                                                                 Page  6
  193.  
  194.  
  195.       /SZ: [(] [)]  nnn    Select a file based on its size.  The
  196.                 left paren indicates that files less than the
  197.                 indicated size are to be selected.  The right
  198.                 paren indicates to select files greater than the
  199.                 size.  If right or left paren are not specified,
  200.                 a left paren is assumed.  Following are examples.
  201.  
  202.                 /SZ:100    --  Select files less than 100 characters
  203.                 /SZ:(100   --  Select files less than 100 characters
  204.                 /SZ:)100   --  Select files greater than 100 characters
  205.  
  206.  
  207.       /T        Test the command.  Use this switch when you
  208.                 would like to test the command entered without
  209.                 actually updating any files.
  210.  
  211.                 Messages will indicate what will happen if the command
  212.                 is executed without the /T switch.
  213.  
  214.  
  215.       /AY       Set the ARCHIVE attribute for the file on.
  216.  
  217.  
  218.       /AN       Set the ARCHIVE attribute for the file off.
  219.  
  220.  
  221.       /HY       Set the HIDDEN  attribute for the file on.
  222.  
  223.  
  224.       /HN       Set the HIDDEN  attribute for the file off.
  225.  
  226.  
  227.       /SY       Set the SYSTEM  attribute for the file on.
  228.  
  229.  
  230.       /SN       Set the SYSTEM  attribute for the file off.
  231.  
  232.  
  233.       /RY       Set the READONLY  attribute for the file on.
  234.  
  235.  
  236.       /RN       Set the READONLY attribute for the file off.
  237.  
  238.  
  239.                                                                 Page  7
  240.  
  241.  
  242.       Examples:
  243.  
  244.          Show all attributes for files in current directory
  245.  
  246.              PATTR *.*
  247.  
  248.  
  249.          Set ARCHIVE attribute off for all *.BAK files on disk
  250.          in drive A:
  251.  
  252.              PATTR *.BAK /S/AN
  253.  
  254.  
  255.          Set READONLY attribute on for all *.SPC files in \SAVE
  256.          directory.
  257.  
  258.              PATTR \SAVE\*.SPC /RY
  259.  
  260.  
  261.          Set HIDDEN attribute on for all files in \SECRET directory
  262.  
  263.              PATTR \SECRET\*.* /HY
  264.  
  265.  
  266.          Reset all attributes for all files in current directory
  267.  
  268.              PATTR *.* /AN/SN/HN/RN
  269.  
  270.  
  271.                                                                 Page  8
  272.  
  273.  
  274.       Registering PATTR
  275.       -------------------
  276.  
  277.       PATTR is distributed under the Shareware concept.  This mak